^ A Man Page 
I Q Listing 



Tliis chapter lists the man pages for backup and restore 
commands, volume management commands, media duplication 
command, and HSM commands. You can display a full 
description of each command by typing man followed by the 
command name. 

The following three categories of man pages are described; 

• Backup and Restore Man Pages 

• Volume Management Man Pages 

• HSM Man Pages 
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Backup and Restore Man 

Pages 


Tliis section describes backup and restore commands tlial can 
be run from the EDiM seiver. These commands can be used, 
among otlier tilings, to initiate backups (ebbackup) and 
restores ( ebrestore and ebcrecover), start the EDM window 
(edm and edmrestore), and generate a variety? of reports 
(ebreport and ebcreport) directly from the EDM server's 
command line. 


Backup and Restore 
Commands and Daemons 


Description 


eb 


Introduces the VBM Backup product, programs, daemons, and man 
pages. 


eb_bui 1 d_h tab 


Updates the database of ]:ost,s known to the EDM Backup Client Instal- 
lation wizard. 


eb_dc_backup 


Starts an EDM Symmetrix Connect backup, 


eb_dc_res tore 


Kcstorcs data backed up via a direct connect backup. 


eb deinstall client 


Deinstalfs the EDM Backup client software using the command-line 


eb deinstall_server 


Deinstalls the EDM Baclaip seivei' software using tJre command-line 
interface. 


eb_ins tall_client 


Installs (he EDM Backu]:i client soltwai-e (called by the EDM Backup 
Client installation Wizard). 


eb install server 


Configures the EDM Backup ser\'er soim'are (called by 
eb_server_config). 


eb_r eh ome_cl i en t 


Updates an EDM Backup client to know thai it lias a different EDxM 
Bacloip sei-ver thiin the one from which it was originally installed. 


eb server_conf ig 


Configures a host for use as a backup seiner or deconfigures it. 


eb sybconf_db 


Configures online Syljase database backups. 


ebbaokup 


Initiates and controls client bac1<ups under EDM Backup. 
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Backup and Restore 
Commands and Daemons 



Description (Continued) 



etJaackupd 

ebcatalogd 

ebcatclean 

ebcatcomp 

ebcatproc 
ebcatsort 
ebcp 

ebcrecover 

ebcreport 

ebexpire 

ebf s_dump_vol 

ebimport 
eblistend 

ebrestore 



I'erforms a backup of a single client system under EDxM Backup, 
Supervises tlie post-processing of baclcujD catalogs. 



Deletes backups, catalogs, and sa\'-esei I'ecords that expired or are 
unrefei'enced under EDM liackup. 



a backup catalog file and c 



Coi«pletes ihe inioniiai 
backup catalog deltas. 



Forces the processing of a baclcup catalog. 
Sorts an EDM liaciaip catalog file. 



Copies data from one place to anotlier on an EDM liackup si 
EDM Migration client, or between two sucli machines. 



Provides an easy way to execute the ebrestore command from an 
EDM Backup client using the client's native connection method, (il 
actuaUy calls ebrecover on the EDM, which is just a symbolic link to 
the actual restore program, ebrestore.) 

Enables users to run ebreport from an E15M Backup client using the 
client's native connection method. 

Deletes backup data, savesei records, and backup catalogs that have 
expired under the EDM Backup system. 

Reads a volume of backup media producing a hexadecimal listing of 
its contents an/or an extended-cpio stream that can be read by 
recxcpio to restore a directory hierarchy. 



Imports backup media, backup catalogs, and save: 



Ustens foi- requests from DBMS clients lor backups and restores, and 
starts them as needed. 



Restores backup files from backups a-eated by the E13M Backup 



Produces several liackup reports including media, history, and disaster 
reports. (See Chapter 16 "Backup Reports and Log Files".) 
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Backup and Restore 
Commands and Daemons 



Description (Continued) 



ebtreegeti 
edm 

edmcre store 

edmhelp 

edmlinkq 

edmproc 

edmr emote 



edmrestore 

epcleanup 

epcoinm_util 

epnewlog 
epshovnnod 
epshowpath 
epshowprod 



Generates a tree index for a backup catalog file. (Evoked by 
ebcatalogd ) 

Starts the EMC Data jManager graphical user interface. 

Starts the EDM Resioi-e window and displays it on the backup client. 

Starts the online Help facility for the EDM. 

Allows you to cjueiy tlie i-emoie client via the EDM Transfer Protocol 
to ]3iwide N'ersion and capabilirs' information. This lias the side-effect 
of allowing the clieni-ser\'er connection lo be tested. 



LisLs, starts up, shuts down or restarts all edm daemon processes, 
edmproc performs the start up/shui down operations in the corre 

Starts the EDM GUI on a remt^le EDM seiver and displays ii on a 
specified Itosi. 



smed reports on currently rxmning oi- completed backups on 
a local EDM or on an EDM Domain. If using a domain, the EDM 
Domain Master tnachine must be a tnisled machine, because the local 
administratoj- can change j^asswords and nin the edmreport CLl 
without knowing the 13omaii5 Login Credentials. 

Starts the EDM Restore window on the EDM Backup sender. 

Removes files thai are no longer needed. Usually wn from crontab. 

Command line utility for communicating witli the EDM Client Commu- 
nications Daemon, epcommd. 

Rotates, archives, or truncates system logs. Usually mn from crontab. 
Displays all or selected installed EDM modules. 
Displays the installation loaition of EDM software. 
Displays infoi'mation for a selected or all installed products. 
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Backup and Restore 


Description (Continued) 


Commands and Daemons 


epshowvers 


Displays all products and their versions available on the EDM disli'l- 


biuion CD. 


optiiruiicXo^ 


Truncates the daily message log file and mails a copv to specified 




users, This is usually run IVom croniab. 


£ indxcpio 


EDM Backup's client find and xcpio program. 


ntexchreport 


Reports on the Microsoft Exchange backups that have been imde to 


an EDM ser\'er. 


n texchres tore 


Restores a Microsoft Exchange ob\ect that -vs-as backed up by the EDM 
seiver, 


ntsqlreport 


Reports on Microsoft SQL Ser\-e]- database backups made to the EDM 
seiver. 


ntsqlrestore 


Restores a Microsoft SQL Ser\'er object that was backed up by the 


EDM. 


oldl) exec 


Initiates an Oracle Online backup or restore from the EDM. 


portservices 


Modifies the edm_sen'ices files on the EDM, enabling, changing, and 




disabling port control settings. 


rasd 


RASD (Reliability Agent Scanner daemon) monitors significant system 






recxcpio 


Creates a directory hierarchy that con-esponds to the contents of an 


extended-cpio stream, such as iliat produced by findxcpio and the 




ebrestore program. 


snmpeved 


The SNMl' subagent for Volume Management and EDM Backup. 


sybrecover 


Recovers striped database back tips from the EDM to a Sybase seiver. 


sybreport 


Repons on Sybase backups made to the EDM seiver. 
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Volume Management 
Commands and Daemons 



dbreport 
edmlm 



'Hie Volume Management conunand line interface (CLl) enables 
you to monitor volume management activities and perform 
adtninistrative tasks at the command line level. You can use the 
CLI in a non X windowing environment (such as dial-in-siies). 
The CLl also enable you to write shell sa-ipts to automate 
volume management tasks. 



Description 



Generates volume reports from the volume database. 

Starts the graphical EDM library Unit Managei' separate from the EE 



evmaddtempl 
evmchtempl 

evmchvol 

evmclean 

evmotl 
evmeject: 

evmenable 



Creates a volume template for a specified media type and applicaiion, 

Modifies a volume template for a specified media type and application, 
ihis can be used to increase maximum usage of a template. 

Changes the attribute settings for an existing labeled volume. This can 
be used to increase maximum usage of a volume. 

Cleans drive(s) in a named libraiy unit. Before cleaning a djive. ihe 
cleaning cartridge must be present in the library unit. (See 
Description.) 

Quei-ies or sets attiibutes of the EDM Vtolume Management system or 
individual library units. 

Ejects the specified volume or cleaning cartridge fi-om a libraiy unit. 
This works only with libraiy units that have an'inlet. (See Description 
to get a volumes identifier.) 

Enables a drive or library unit. Volume management disable* a drive 
when certain enoi's occur. 

Imports one or more volumes into a seiver'.s vcdume catalog. Use this 
command when you move volumes from one server io another or to 
reconstiuct a volume catalog that was destroyed. 

Inserts a volume into a library unit. (See Description.) 
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Volume Management 
Commands and Daemons 



evmi nven t ory 
evmlabel 

evmlistd 
evmmount 

evinreject 
evmrmteiopl 

evmrmvol 

evmse terror 



Description (Continued) 



Initiates an inventory of the volui 



n tJie named Jibraiy unit. 



Labels the selected volume by using a specified volume allocation 
template. Use Description -t to list llie names and IDs of all defined 
templates and Description to view a template's attributes. 

Lists all tunning volimie management processes. 

Queues a mount request for tlie specified volume. 

Generally, volume management handles all mount and dismount 
requests. 'I'hercfore, this command is intended only for mounting 
foreign volumes. 

Kejecis a queued request for a volume. 

l^emoves the specified volume template from the volume management 
template datafjasc. 

Removes all knowledge of an existing volume fi-om a server's volume 
catalog. 



volume, or library' unit. 



Provides status oi" volume management system, including devices 
(libraiy units and drives), volumes, media types, and system noiific 



eviatein.pl 
evmumount 

evmvol 
evmwhere 



L^is]5lays attiilxttes of c 



r moi-e volume templates. 



Removes a volume from a drive that was mounted by using 
evmmoxmt. 

Displays attributes of one. or more volumes. 

Describes the attributes that are obtained by mnning evmvol -V. Thi} 
is NOT a command. This man page describes the where -clause 
syntax only. 

C;(jnfigures library managers and device drivers for the EDM, 
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Volume Management 
Commands and Daemons 


Description (Continued) 


vmdaemon 


EDM volume management daemon. 

Note: This commaiad slioiild not be run from the CLI. 


viadup 


Manages media duplicalion for specified trails or volumes by turning 
on duplication for iTianually-duplicated trails. This is also used to 
reschedule duplication for a given volume, in case a duplication failed. 


vmdupcfg 


Displays tlie cun-eni values of the duplication configuration para- 
meters, and allows the values to be changed. 


vmdupd 


Run from the command line to alter the state of the cuiTently-iiinning 
vmdupd daemon that controls the media du]:i]ication, as well as to ' 
display the list of volumes cun-enily scheduled for duplication. 

Only one occun-ence of the vmdupd (iiin without ai-guments) can run 
at a time. 
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HSM Man Panes This section describes the following types of migration 

commands; staging and staging configuration commands, 
network migi-ation server commands, and user level commands. 

Most users do not need tlie user level cominands. These are 
useful for those who set up application environments and for 
those who need to understand filesystem usage patterns. 

User level commands are maj-ked with an asterisk (*) in the 
following table. 



HSM Commands and Daemons Description 



eni_new_volume 
embsi * 



Finds files tliat liave 



with their staging IDs and fixe 



Allocates a new staging volume for a specific staging template, 

Stages specified files in from staging media oi- client stores, which 
ensures thai they are completely resident on magnetic storage. 

Checks the HSM client and sen'er configuration to verify its 
con'ectness, warns you of potential problems, and conects inconsis- 



emcompact 
emcrecover wait ' 



Sets ihe staging control properties for a file or directoiy. Unlike 
chmod, ii clears unspecified properties. 



illy compacts staging volumes. Usually run from croniab. 

Waits for a set of client .store bitfiles to be restoied on an EDM with 
HSM. It scans the set of files listed on the command line and checks 
the stanis of every bitfile referenced by this set. 

I3isplays information about client store usage and identifies the 
cunent staging targets for each stageable filesystem. 

Di.splays the number of KB contained in all files and directories 
specified. Using vhe -v option displays tlie amounl of virtual space, 
which includes the space on the f'iDM if die files have a staging image; 
otheiwLse it is the space on the local magnetic disk. 
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HSM Commands and Daemons 



Description (Continued) 



emf s de conf i g 
emfsreport * 



emlsconf 
ems check 

emschs 
ems conf ig 

emsd 

emsdef s 
emshalt 



RecursiN'ely descends tlie directO]-y liierarcliy for each pathnai 
patlmame-list, seeking files that match a logical expi-ession. 
Supports several additional predicates over find. 



Configure 
templates 
filesystem 



HSM fllesystems by assigning filesystems to staging 
removing filesystems from staging templates, and changing 



Deconfigures a migration filesysten- 



Produces virtual filesystem 
stageable filesystem data, and tin 
staged. It displays your working 

Lists file attributes. Similar to Is, but lists staging attributes, including 
the number of KB on magnetic disk, the number of KB currently 
staged out, and seiver and client store if any, to which the file is 
staged, as well as the staging control properties, such as residence 
piiority. 



It displays the amount of 
nount of data that is currently 
in days of usage. 



Displays the c 



It staging configuration parameters. 



Checks the network migration sei-ver configuration files. The 
emscheck command ciiecks all global and store specific files for 
syntactic and semantic coneciness. In addition, it performs ceitain 
clean up operations on client stores. Run emscheck nightly via cron. 

Changes certain configuration parameters for an existing store. 



rface parameters. Only i: 
Drganization. 



Changes the protocol ii 
of your customer servic 

The network migration seivej- daemon. The emsstart command 
always invokes tliis daemon during system stamip. The daemon 
handles all network client HSM protocol requests from the client 
systems. 

Changes ceilain default store configuration parameters. Hie emsd 
command affects the operation of the emsmks command. 



'S tlie network migi'ation ser\'er. The emshalt command kills 
the ninning emsd pj-ocesses and aborts any outstanding staging 
operations. 
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HSM Commands and Daemons 


Description (Continued) 


emsinit 


Initializes the netvs^ork iiiigration sen-ej- configiiralion files, if no 
configuration files exist, emsinit creates an initial configuration wiili 
no stores and standard default definitions. The emsinit comtn and is 
normally only nan during installation. 


emslss 


lists all configured stores, or individual stores selected bv name or 


emsmks 


Makes a client store. You can also use emsmks to insert an existing 
store tree into a sen'er configuration database. 


emsmvs 


Kenames and/or moves an existing store. 




Kemoves an existing store, 


ems start 


Initiates the network migration seiver. This has no effect if the 
network migration seiver is already running. The emsstart command 
is am during system startup. 


ems Stat 


Displays network migration server usage statistics. It disj^lays both 
cumulative and incremental statistics, Lise emsstat to determine the 
cunx'nt status of network migration semces. 


ems t age * 


Explicitly stages out the specified files. You must be the file owner or 
the supeniser to use this command. 


emstconf 


Ci-eates new staging lemjDlates, I'emoves existing staging templates, 
and changes parameters for existing staging templates. 


emsundel 


Stans a restore nan to retrieve bitfiles listed in the recover_iist files. 
Only nm emsundel when an operator is available to handle voluine 
mount requests. 


emsysconf 


Sets system-wide staging parameters in the configuration database. 


emvck 


Checks and coirecis staging volume statistics, 'niis is usually run from 
croniab. 


restage 


Stages or restages files to the specified staging ti'ail. 
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EDM Softwam Reference 



Party 

Disaster 

Recovery 



<4 f% Being Prepared 
I for a System 
^ Disaster 



If there is a disastei-, you should be prepared for a disaster 
recoveiy. However, feel free to call Customer Service with 
questions. 

CAUTION: Do not wait for a disaster to read this 

chapter. The information in this chapter is 
about steps tliat must be taken with each 
backup so that you will be able to recover 
when a disaster occurs. 

This cliapter tells ycju how to prepare for the disaster recoveiy 
of your backup files. Tlie following two cliapters contain overall 
disaster recovery procedures to use v>'hen you experience a disk 
a-ash on an EDM server or client. Because each disaster is 
unique, these steps are presented only as a guide and not as all- 
inclusive, step-by-step instructions. 

CAUTION: Performing a disaster recovery requires 
experience with EDM Backup adminis- 
tration (and HSM administration, if you 
have the HSM option), UNIX system admin- 
istration, and the site environment. 
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You must establish a disaster stmtegy and safeguai-d your media 
and xhe reports before a disaster occurs. Otherwise, you will not 
have the necessary information to recover your system to its 
original state. 

Note; You should develoj^ a djsa,ster recoveiy plan thai 
meets your specific organizational goals. Actual file 
recoverv' can be as .simple as off-site lajDes. or as 
complex as duplicate Symmetrix systems utilizing 
SRDF/Timefinder. 

To fully recover from a system disaster, you must run regular 
backups, safeguard your backup media, and run and save tlie 
appropriate backup reports. You can provide additional 
protection by creating redundant media and storing it offsite. 



SsfBQjUSrding Your To be prepared for a system disaster; you must nan regular 

BSCkup Media backups and save the backup media for botli the current and 

previous full rotation periods. For example, assume the 

following: 

• The rotation period is 7 days. 

• A full backup is run on Monday. 

• Every backup generates a single new piece of media. 

If today is Tuesday, you need the media tliat was generated 
since Monday of die previous week, or the last eight pieces of 
media. Tomorrow, you will need the same eight pieces, plus the 
media that is generated from today's backup. 

Be sure to save tlie backup media in a safe place, preferably 
offsite or onsite in a fireproof vault. 

CAUTION: Failure to have visxially identifiable labels 
on removable media will significantly 
complicate and lengthen the Disaster 
Recovery procedure. 
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Be sure removable backup media is physically labeled (such as 
with barcodes) so ir can be visually identified if needed during 
the disaster recovery process. If barcoding is not used, each 
piece of media must be physically labeled with its assigned 
sequence number. 



Running and Saving At the end of your baciiups for the day, your 

Reports L0CAL_DATAIMSE is automatically backed up, which provides 

you an exact picture of tlie EDM Backup database. 

At the completion of every LOCAL_DATABASE backup, the 
/usr/epoch/EB/config/loca!_db_cleanup saipl automatically 
generates a MINIMAL Disaster Report. By default, this report is 
emailed to all EDM Backup adminisa-ators, appended to 
/usr/epoch/EB/config/disaster-report.log, and printed to the 
default system printer. 

CAUTION: It is essential that you save a hard or soft 
copy of the MINIMAL Disaster Report after 
each backup. Keep it in a fireproof location, 
either offeite or in an onsite fireproof vault. 

If the LOCAL_DA'rABASE work item remains in the schedule for 
more tlian 24 hours witliout being run, it will be forced to run 
immediately. This is knowm as a "late" LOCAL_DA'rABASE 
backup, 'file work item retiiains in tlie schedule to be run again 
normally, or forced if needed. 

ebbackup displays a message and ebreport disaster notes a 
"late" LOCAL_DATABASE backup. 
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MINIMAL Disaster Report rUs minimal Disaster Report is a subset of die FULL Disaster 

Report that ebreport disaster generates. It provides essential 
infomiation that you need to perform a disaster recoveiy on the 
sen'er — a list of media volumes for the most recent 
LOCAL_DAl'AB7\SE baclaip, the cuirent EDM Backup configu- 
ration, the cun-ent Library Manager configuration, copies of the 
key configuration-file settings, and information about baseline 
backups. 

Note: lliis MINIMAL Disa.ster Report does not include 
backup client information. 



FULL Disaster Report You should run tlie full Disastei- Report once eveiy backup 

rotation and whenever significant system changes are made. 
The following example runs the FULL Disaster Report and 
redirects it to a file: 
emc# ebreport disaster > 
~sysadmin/disreports/960917 

See "Backup Disaster Reports" on page 16-19 for a description 
of the TIM. Disaster Report. 
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Redundant Backup In preparation for a possible disaster, it is recommended to have 

COVCraye redundant backup coverage so tliat you can move some backup 

media offsite for safe keeping. Following are tv*fo wa\'s of 
providing redundant backups. 



Configure Alternate Media 
Sets (Trailsets) 



For example, with a rotation period of seven days: 

• with a primaiy trailset only, a complete trailset includes at 
least one full backup and six incremcntals for each work 
item. 

• with an alternate trailset, each complete trailset includes at 
least one full backup for each work item, hut only two or 
three incremcntals. 

With ]5rimaiy trailsets only, move backup media offsite as soon 
as it is older than one rotation period. With alternate trailsets, 
you can tnove each backup volume from one trailset offsite as 
soon as the volume is M). 



One good backup strategy is to configure an alternate media set 
(trailset) for use on alternate nights. (A traiket contains all of 
the media that is used in performing full and incremental 
backups for a backup schedule template in a single i-otation 
period.) 



Media Duplication Another option is to use Media Duplication, which enables you 

to create a duplicate set of backup media automatically after 
each backup session. 

After you configure media duplication in die E13M Backup 
Configuration window, the duplication of a set of backup media 
occurs automatically after each backup session, You can then 
take die duplicate media offsite for safekeeping. 
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This metliod does not use network bandwidth and can te a 
good choice if you liave extra drives. For more information, see 
Chapter 9 "iMedia DupHcation". 
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lliis chapter contains disaster recovery procedures to use when 
you experience a disk crash on a backup server. Because each 
disaster is unique, these steps are presented only as a gtiide and 
not as all-inclusive, step-by-step instmctions, 

CAUTION; Performing a disaster recovery requires 
experience with EDM Backup and HSM 
(optional) administration, UNIX system 
administration, and the site environment. 

To restore a backup ser\'er, detemtine the extent of the damage 
and disable backups, replace any damaged disks, reinstall tlie 
operating system, and reinstall any lost EDM Backup or HSM 
solWare. 

Prior to restoring lost files, you import the volume management 
and backup catalog database information and tlien use EDM 
Backup to restore tlie databases as tliey were at the time of the 
last LOCAL_DATABASE backup. After doing tltis, you can 
restore all of tlie data from changes that occurred after the last 
I.OCAL_DATABASE backup. 
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The procedures in this chapter arc based upon tlie example in 
Figure 20-1 that shows the actions that occurred before the 
disasta- in the simplest case. Figure 20-2 illusti-ates tliese and 
other actions that may have occurred before the disaster. 



Figure 20-1 Disaster Immediately after the LOCAL_DATABASE Backup 

ABC 

A. Backup of filesystem with catalogs 

B. Remote client work item backup 

C. LOCAl._DATABASE backup 

Your disaster could occur immediately after your last 
LOCAl._DATABASE backup (Step C, above). If so, follow all of 
the sections except tliose that are marked "For changes after tlie 
last LOCAL_DA']ABASE backup." 
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Figure 20-2 



Disaster after Other Possible Actions 



A B C D E F G hL^S'^ Disaster 



B. Remote client work item backup 

C. LOCAL_DATABASE backup 

D. Appended backup 

E. Completion of duplication of volumes 

F. Change in configuration of Library Units 

G. ebexpire {run either by cron or manual) 

H. Backups that completed after LOCAL_r3ATABASE backup 



Events, such as D, E, V, G and M in Figure 20-2, may have 
occurred (in any oj-der) alter the last LOCAL_IM'rABASE 
backup. If your disaster occurs after one or more of the>se, read 
ALL sections in the chapter, including tliose tliai are marked 
"For changes after tine last LOCAL_DATABASE backup," and 
follow those tlial fit your situation. 



A. 



Backup of filesystem with catalogs 
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StBpS to ROStOrB 8 SorVCr Tlie actic^ns that are requii-ed to restoi'e a sei-ver from a disk 

failure are discussed in this chapter. Follow the steps below to 
restore a backup server in case of a disk crash or major loss of 
files. Your situation may vary from this example and you may 
not need all of these sections. If some frlesystems remain inl:tct, 
you may be able to skip some steps. You should adjust your 
disasle]- recovery ste]3S accordrngly. 

You need information horn the Disaster Report for many of 
these steps. For information about this repon, see ''Running and 
Saving Repoits" on page 19-3. 

Note: Ihe proc-edures thai follow use einc as ihe name of 
the sen-ei-. Sub.stitute the name of )'out own sci'ver 
in each of tlie examples. 

Each of the following steps are described in the following 
sections of this chapter Perfomi them in the order given. 

1 . Stop All .Activitv' on the Sen-er 

2. Reinstall Hardw^are and Software as Needed 

3. Temporarily Reconfigure the Server 

4. I^estore LOC.4L_DATABASE Files 

The next two steps are only done if you made changes after the 
last LOCAL_DATABASE backup. 

5. Reconfigure l.ibraiy Units 

6. Restore Catalogs and Backup Information Created After 
LOCAL_DATABASE Backup 

Follow these steps for all disastei- recoveries. 

7. Restore Data Created Before LOCAL_DATABASI£ Backup 

8. Reenable crontab Entries 

9. Restore Past Catalogs 
10. Restore Mis,sing Catalogs 
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Stop All Activity on the 

Server 



Because you pejform all of ihe resioj-e in multiuser mode, you 
must notify the user commuiiity to stop all activity' on the seiver. 
No one should be able to log in. 'Hie sei-vei' must be inactive 
before you j^erform any disaster reco\'ery procedui-es. 



Disable Activity 



Edit root's croniab file (/var/sjiool/cron/crontabs/root) on the 
server to comment out all backup and HSM staging commands 
that may start up automatically. Following are commands to 
comment out: 



00 0 * * * /bin/kill -1 'cat /usr/epoch/etc/nial/eiranasterd.pid* >/dev/null 
2>&] #EPCmalc 

15 23 * * /usr/epoch/bin/einvck >/dev/rjull 2>6l#EPCmalc 

00 1 * * * /usr/epoch/bin/emcompact -c >/dev/null 2> {<l#EPCmalc 

00 2 * * * /usr/epoch/bin/emscheck >/dev/nuli 2>Sl#EPCmalc 

00 3 * * * /usr/epoch/bm/emsundel >/dev/null 2> SllEPCmalc 

00 18 * * * /usr/epoch/EB/bin/ebbackup default >/dev/null 2>£l JEPCebs 

00 11 * * * /usr/epoch/EB/bi.n./ebexpii-e -expire -purge >/dev/null 2>&1 ttEPCebs 

00 1 ■* * * /usr/epoch/EH/bin/ebcatclean -fix_saveset >/dev/null 2>&1 ttEPCebs 

00 3 * * * /usr/epoc.h/EB/conf ig/local__dbjv;arning >/dev/null 2>sl ilEPCebs 
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Reinstall Hardware and Before you perfoi-m a restore, you must Irave your hardwzre 
Software as Needed and software in the same condition as that before the disaster 

occurred. 

13etermlne the extent of the damage to bodi hardware and 
software. Be sure to identify' and replace all damaged liardwai'e 
before restoring any software. 

1. Check hardware and replace if necessary. You c^n use die 
disk diagnostics capability' of a program sucli as format to 
detemiine wliether anything is wrong with your disk. 
Make sure tlie replacement hardware is fully compatible 
witli the system you had before tlie disaster, liach new disk 
should have at least die same storage capacit)? as die old 
disk. 

CAUTION: Do not continue with software recovery 
until you are absolutely certain that the 
disks are free of hardware problems. 

2. Check tlie filesyslems for loss of software, starting widi the 
operating system. 

If ,/ or Aisr was destroyed, reinstall the server s native 
operating system following tlie platfoi-m-specific in.struc- 
tions that are provided with your server. This partitions your 
disks, restores die root filesystem, and restores die portion 
of ,/usr that the operating system loads. 
To partition the disks coi'recriy, use the disk configuration 
data f]-om the last Disastei- Repoit (which is descriised in 
"■Running and Saving Reports" on page 19-3) See 
Figure 20-3 on page 20-7. Make sure you rebuild tiie.se 
filesystems to die same size (or larger) and the same 
number of inodes (or more) as they were before the 
disaster (xcurred. 
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Figure 20-3 Locally Mounted Disks from the Disaster Report 

Displaying locally mounted disks... 



/ (/dev/dsk/cOtSdOsO ): 8192 block size 1024 frag size 

230302 total blocks 929BB free blocks 69968 available 60416 total file 
56761 free files 8388632 filesys id 

ufs fstype 0x00000004 flag 255 filename length 

/usr (/dev/dsk/c0t3d0s3 ) : 8192 block size 1024 frag size 
673742 total blocks 295032 free blocks 227672 available 169920 total f 
153786 free files 8388635 filesys id 

ufs fstype 0x00000004 flag 255 filename length 



766 tota. 
,93845 free 
ufs fstype 



v/dsk/c0t3d0s4 ) : 8192 block size 1024 frag size 
blocks 396532 free blocks 319072 available 196352 total f 



8388636 filesys 
0x00000004 flag 



255 filename le 



3. ]f you liave an HSM system, you need to i-einstall VEI^TAS 
VxFS. See your \TRIT.iS File System (VxFS) Quick Start 
Guide. 

Note: If you are reinstalling the operating system, you 
need a VxFS license. 
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4. Verify wheilier the filesystem tliat contains tlu- iMcliup 
software is damaged or missing (the EDM Software 
1-ilesystem, /ep_usr in the example in Figure 2{)-4), 

5. Check the Disaster Report to see what you had at the time 
of tlie last report. 



Figure 20-4 Displaying /etc/vfstab... from the Disaster Report 

Displaying /etc/vfstab... 



Oct 3 14:23 1998 /etc/vfstab Page 1 



#device device 


mount 


FS 


fsck 




#to mount to fsck 
# 


point 


type 


pass 


at boot optii 


fd - /dev/fd 


fd - no 








/proc - /proc 










/dev/dsk/c0t3d0sl 


swap 








/dev/dsk/cOtSdO-sO 


/dev/rdsk/c0t3d0s0 




ufs 


1 no 


/dev/dsk/c0t3d0s3 


/dev/rdsk/c0t3d0s3 




ufs 




/dev/dsk/c0t3d0s4 


/dev/rdsk/c0t3d0s4 


/ep_usr 


ufs 




/dev/dsk/c0tld0s2 


/dev/rdsk/cOtldOs2 


/data 




2 yes 


/dev/dsk/cOtSdOsO 


/dev/rdsk/c0t5d0s0 


/datal 


vxfs 




/dev/dsk/c0t5d0sl 


/dev/rdsk/c0t5d0sl 


/data2 


v.xfs 


2 yes 


/dev/dsk/c0t5d0s3 


/dev/rdsk/cOt5dOE3 


/dataS 


vxfs 


2 yes 


/dev/dsk/c0t2d0s0 


/dev/rdsk/c0t2d0s0 


/data6 


vxfs 




/dev/dsk/c0t2d0sl 


/d6v/rdsk/cOt2dOsl 


/data7 


vxfs 


2 yes 


/dev/dsk/c0t2d0s3 


/dev/rdsk/c0t2d0s3 


/data8 


vxfs 


2 yes 


/dev/dsk/cOtOdOsO 


/dev/rdsk/cOtOdOsO 


/data3 


vxfs 




/dev/dsk/cOtOdOsl 


/dev/rdsk/cOtOdOsl 


/data4 


vxfs 


2 yes 


sv/ap - /tmp 


tmpfs- yes 
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>. Use the Installation Report portion of the Disaster Report to 
detemiine whicli of the various binaries were actually in 
/usr and which were symbolically linked to another 
filesysrem. 1'he EpochBackup Installation Report section 
shows the directories and symbolic links lor xhc backup 
software. 

In the third line of the split-install example shown in 
Figure 20-5 on page 20-9, the backup software is installed 
in /ep_usr/epoch and a symbolic lijik is in /iisr/epoch and 
]:ioint.s to /e]3_usi;''epoch. 

Also, in this example, catalogs, db, and log are installed in 
/'data/epoch/EB/ and a symbolic lin]< is in /usr/epoch/EB 
and points to them. 



Figure 20-5 Installation Report In the Disaster Report 

EpochBackup Installation Report for server adarr. at Oct 13 09: 01: 14 1998 
Report options: -all 

Installed Software: 

EDM High- Performance Centralized Backup with HSM 
abbreviation: edmhsm 
version: 4.0.0.5 
server platform: sun4_5.5.1 
platform: sun4^5.5.1 
patch id: none 
install date: 19971110165742 

modules: EPCgl EPCtps EPCsnmp EPCesl EPCdevlib EPCdev EPCelmlib EPCelm 
EPCebhslb EPChsesdm EPCmalib EPCmalc EPCmawrp EPCebsedm EPCebc EPCqui 
EPColdoc 
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(Installation Report Continued from previous page.) 

Oracle Platinum On-Line Database Backup 
abbreviation: oraplt 
version: 1.1.0.5 
.server platform: sun4_5.5.1 

patch id: none 
install date: 19971112104243 
modules: EPCoraplt 
status: complete 

EpochBackup currently running load 7.0.0.0 

/usr/epoch IS A SYMLINK to /ep__usr /epoch 
/usr/epoch/EB is a real directory under /ep_usr/epoch 
/usr/epoch/GENDlR IS A SYMLINK to /home/epoch 

/usr/epoch/EB/adam is a real directory under /usr/epoch/EB 
/usr /epoch/EE/bin is a real directory under /usr/epoch/EB 
/usr/epoch/EB/catalogs IS A SYMLINK to /home/epoch/EB/catalogs 
/usr/epoch/EB/cli ent is a real directory under /usr/epoch/EB 
/usr/epoch/EB/conf ig is a real directory under /usr/epoch/EB 
/usr/epoch/EB/db is a real directory under /usr/epoch/EB 
/usr/epoch/EB/locks is a real directory under /usr/epoch/EB 
/usr/epoch/EB/log IS A SYMLINK to /home/epoch/EB/log 
/usr/epoch/EB/preconfig is a real directory under /usr/epoch/EB 
/usr/epoch/EB/tmp is a real directory under /usr/epoch/EB 

The local client is of the type: sun_sun4_v55_srv 

The client backup username is: ebadmin 

The user ID for ebadmin is: 24375 
The group ID for ebadmin is: 25 
The home directory for ebadmin is: /usr/epoch/EB 

Client chip is of type ibm_r s6000__v325 (6.0.0.0), installed Tue May 20 14:05:23 199 
Client yyz is of type windows_nt_all (5.0.0.0), Installed Thu Sep 11 15:04:42 199 
Client perf-prol is of type windows_nt_all (5.0.1.0), installed Thu Sep 25 15:58 199 
Client pilgrim is of type sun_sun4_v54 (6.0.0.0), installed Thu Oct 23 15:53:58 199 
Client adam is of type sun_sun4_v55_srv (6.0.0.0), installed VJed Nov 12 11: 03:07 199 

End of EpochBackup Installation Report for server adam at Mar 13 09:01:14 199B 




Backup 
Software 



Backup 
Software 
Directories 
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7. Reinsrall the backup software. 

Use the data from the Installation Report section of tlie 
Disaster Report to determine where and hov\' it had was 
installed most recently (see Figure 20-5 on page 20-9). 

a. If the fil&system that contained tlie backup software 
was destroyed, reinstall the software as a scratch instal- 
lation. See your Sofiware Installation manual. 

b. If the filesystem that contained die backup software is 
still intact l3Ut /usr was destroyed, you need to recreate 
the symbolic link from /usr that poinLs to this 
filesysiem, which contains the backup sofra-are. 

To match the example in Figure 20-5 on page 20-9, 
enter the following (specify your own installation 
directory): 

emc# In -s /ep_usr/epoch /usr/epoch 



Temporarily Reconfigure 
the Server 



You must configure the library unit by using linconiig, and 
dien a temporary backup configuration by using 
eb_server_config. 



imconfig 



1. Obtfiin the Imconfig data from the Disaster Kcpon 
(see Figure 20-6). 
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Figure 20-6 Library Manager Configuration from the Disaster Report 

Displaying library manager configuration (used with Imconfig...) 

* Lu_nairie Name ID Statu 



L cffline_0 
h offsite_0 
L at_dlt_3264_0 
D at_dlt_3264_0 
D at_dlt__3264_0 
D at___dlt__326^_0 
L hp_m.f_cl7xx_0 
D hp_mf_cl7xx_0 
D hp mf^cl7xx_0 
D hp_ir>f _cl7xx_0 
D hp_mf__cl7xx_0 



(0,1,1,0) 
(0,1,5,0) 
(0,1,4,0) 
(0,1,3,0) 



(0,2, 5,0 
(0,2,4,0 
(0, 
(0,2,1,0 



,0) 



synced 
synced 



rnabled 
enabled 
■nabled 
enabled 



2. Remove all of tlie media i'rom tlie library? unit iliat you just 
configured and put the media aside, in their own box or 
some olhei- location where they cannot be confused with 
otlier media. You reuse tliese media when you i-estore die 
catalogs (see page 20-23). 

This significantly shortens the time that is required to 
invenroiy this libraiy unit when you reboot the seiver. 
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3. Using Imconfig, install the drivei's for a library unit tteii 
Kuppoits ilie media yon use later lo import and I'esioi-e the 
LOCAL_DA'rABASE backaip. 

See Chapter 17 "Configuring Library Managers" for details 
about running Imconfig. 

Note: You can save a significant lime by configuring only 
one librar)' unit, even if more than one is available. 

4. Use the CONFIG option of Imconfig to configiire the 
libraiy unit. 

Note; ]i'You use the AOTOCONFIG option, you must 

leave at least one piece of media in the TLIJ. If vou 
do this, leave the piece of media required for 
1.0CAL_DATABASE restore, 

5. Using the LOCAL_DATABASE volumes section of the 
Disaster Report (see Figure 20-7 on page 20-16), reinsert the 
volumes that contaiixs the LOCAL_DATABASE backup into 
the library unit that you configured. 

6. l^eboot the server again with the following command: 
emc# /usx/sbin/shutdown -y -16 -gO 

The Library Manager performs an inventoiy of tliis library' 
unit. When the inventoiy is complete, continue to the next 
step. 



Configure a temporary EDM Backup configuration, 'Hie original 
EDM Backup configuration is restored later, when you restore 
the LOCAL_DATABASE files as described in tlic next section, 
1 , Deteraiine whether the backup server sofnvare was a split 
directory or single directory server configuration. 
Look at the Installation Report in the Disaster lk»port (see 
Figure 20-5 on page 20-9). 
a. If catalogs, db, and log are real directories, not 
SYMLINKs, you have a single directoiy installation. 
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b. ]f eitlier catalogs, db, or log are SYMLlNKs to another 
di]-ectory, you Irave a split directory installation. 
2. l^un eb_ser\''er_config and respond to die prompts to 
recreate the installation and configuration of the server, as 
indicated in the Installation Report. 

a. If tlie previous installation was a single directory instal- 
lation, you need to select no when asked if you wish to 
install into a "split" direcioiy. 

b. If the previous installation was a split director^' instal- 
lation, you need to select j'{?5 when asked if you wish to 
install into a 'split" directoiy. 

c. Determine the parent directory of the catalog, db, and 
log directories (in Figure 20-5 on page 20-9) that would 
be /usr/epoch/EB, and enter that path when asked for 
the name of the target directoiy. 

d. Determine the client backup username by examining 
the Installation Report of die Disaster Report 

(see Figure 20-5 on page 20-9), and enter it when 
asked. 

e. Answer the remaining questions as you did in tlie 
original installation and as shown in the Disaster 
Report. 
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Restore LOCAL DATABASE Once all hardware and sofr^'are are in place, and you tempo- 

Files rarily reconfigured the server, you need to restore your most 

recent LOCAL_DATABASE baclcup. 

1 . Import the original or the duplicate volumes tliat contain 
the LOCAL_DATABASE backup (which was inserted at step 
5 on page 20-13) into tlie Volume Manager catalog, 'lb do 
this, entei': 

emc# evmimport -1 libraryUnitNanie -a 

where LibraryUnilName is the name of the library unit you 
configured earlier in the procedure. The -a option causes all 
of the volumes in that libraiy unit to be imported. 

2. Use the LOCAL_DATABASE section of the Disaster Report 
(see Ingure 20-7) to get the saveset ID and first volume ID 
of the LOCAL_DATABASE backup. 

Note: If you plan to use duplicate volumes, you only need 
to load the duplicate volumes in the libraiy unit. If 
tlie original \'olume is in the offline stale, the substi- 
tution of duplicates liappens automatically. Always 
use the original voluiue IID when needed in the (^I.I 
commands or in the ebimpori CLl, do not use tire 
duplicate volume ID. 
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Figure 20-7 LOCAL_DATABASE Section of the Disaster Report 

Saveset ID Original Volume ID Duplicate Volume ID 

EDM Backup MINIMAL Disaster Report for server "elf '7 on May 18 13:05:42 1999 

L0C7-iL_DATABASE Backuj Volumes Repo :t / 

The follovv-ing volumes contain the iiost recent La5CAL_DATABASE backup 
which will be required in the even: of a Disasl/er Recovery: 

Saveset ID |7271A0D4 . 374D80oi| for L()CAL_DATABs/sE backup on 5/17/99 16:45 
backup^DLT 4=0010 |(38DD0iFC8C977D9^ ) [ oric/inal] - currently in 
library unit "de__dlt_y.7 00_0" , slot #5 / 

backup_Dl..T #0011 r(EBDD020907E7 9824 ) [ duplicate] - currently in 
library unit "de_dlt_x700_0" , slot #3 
This LOCAL_DATABASE backup will require 27.2 ME of disk space to be recovf 

3. Import llie LOCAL_DATABASE backup to restore the 
saveset records and catalogs. 

J^un ebimport using the -media option (with die 
l6-character original volume ID listed in parentheses for the 
LOCAL_DATABASE backup volume) and die 17-character 
LOCAL_DATABASE saveset ID, as follows: 

emc* ebimport -media 38DD01PC8C977D94 7271A0D4 . 3740B006 

I I 

Original Volume ID Saveset ID 

At this point, enough data is restored to restore the 
LOCAL_DATABASE backup. 

4. Make sure catalog processing completed. To do this, enter: 
erac# ebcatalogd -status 

Wlien it reports that all catalogs are processed, continue to 
the next step. 
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If you have an HSM system, reconfigure all migration 
controlled filesysiems that must be restoi'ed. 
Refer to emlsconf output (see Figure 20-8 on page 20-18) 
in the Disaster Report and use exactly the staging param- 
eters that it reports as arguments to the emsysconf, 
emstconf, and emfsconf commands. Valuable control 
infoi'mation was lost when die filesystems were damaged 
then recreated. This conu-ol information is recreated when 
you run emfsconf. 
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Figure 20-8 EpochMigration Local Configuration from the Disaster Report 

EpochMigration Local Configuration 

EpochMigration System Conf iguxation : 

Eriable_stage_outMax_trailsEnable_self _describirig 
Y 3 N 



aging trail "Retrieve_random" 
Stage outs enabled; Y Media: EO Unrestricted 
Self -Describing enabled: N 
Enable HWM LWM PSWM Delay Mntpoint 

68 34 17 0 defaults for Retrieve_^ 

aging trail "Retrieve_cached" 
Stage outs enabled: Y Media: EO Unrestricted 
Self-Describing enabled: N 
Enable HWM LWM PSWM Delay Mntpoint 

95 88 BO 0 defaults for Retrieve^cac 

aging trail "Archive" 
Stage outs enabled: Y Media: EO Unrestricted 
Self -Describing enabled: N 
Enable HVJM LWM PSWM Delay Mntpoint 

68 34 17 0 defaults for Archive 



Staging trail "Trail__l" 

Stage outs enabled: Y Media: EO Unrestricted 





Self-De 






labled: 


N 




Enable 


HWM 


LWM 


PSWM 


Delay Mntpoint 


Y 




78 


64 


0 


defaults for Trail_ 


Y 




d 


d 




/data 


Y 




88 


80 


20 


/data2 






88 


80 


30 


/data3 


Y 


90 


68 


45 


70 


/data7 


Y 


95 


88 


80 


10 


/datal 


Y 




88 


80 


60 


/data6 


Y 


95 


88 


80 


40 


/data4 


Y 




68 


80 


50 


/dataS 
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6. Select a temporary location for LOCAL_DA'rABASE. 

CAUTION: You cannot use a filesystem that is enabled 
for HSM for tlie temporary location of the 
LOCAL_DATABASE. (See Figure 20-8 on 
page 20-18 for tlie configuration of such a 
filesystem.) 

CAUTION: Tlie LOCAL_DATABASE backup must not be 
restored in place (to its original location), 
or the temporary database files tliat were 
just created and are being used to restore 
the origuial database are overwritten. This 
causes the disaster recovery process to faiL 

You must have a filesystem witli enough free disk space to 
restore the LOCAL_DAXA.BASE backup to a temporaiy 
location. Tlie amount of required disk space is noted in the 
LOCAL_DA'rABASE portion of the Disaster Rejiort (see 
Figure 20-7 on page 20-16). If the filesystem you choose is 
the same filesystem tliat contains the EDM software, you 
need twice as much free disk space as noted in the Disa,ster 
Report. 

7. Use ebrestore {not the EDM Restoi-e windo\A-) to restore 
the LOCAL_DATABASE backup to the tem]5orary location 
determined above, such as 
/newpatlv'newclir/temp_local_db. 

This restores critical files originally located in /'usr/'epoch. 
emc# mkdir -p /newpath/newdir/tenip_local_db 
emcA ebrestore -w emc : LOCAL_DATABASE -c emc -D emc 
-d /newpath/newdir/temp_local_db / 

Note: In "-w emc : LOCAL__DATABASE, " "-c emc," 
and "-D emc,'' "emc" is the name of the setvcr. 

8. Now mn a full label and barcode inventor\' to avoid 
duplicate entries in the catalog. You can run an inventory 
by using tlie evminventor>' command (refer to the 
evmlnventory man page), or tlirough the library Unit 
Manager window. (Refer to EDM online help for more 
information.) 
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9- Stop the following on the serve]' as shown: 

a. Stop catalog processing by halting the ebcatalogd 
daemon. To do this, entei": 

emc# ebcatalogd -halt 

Note: emfmd must be ruiming on I ISM ser\-ers. 

b. List the applicable backup, volume management, and 
HSM daemons with the follov,'ing command: 

emc# edmproc 

c. Slop the daemons with the following command: 
emc# edmproc -shutdown 

d. Verify tliat all processes are stop]Ded. 
emc# edmproc 

On an HSM system, emfmd should still be running. On 
a system without HSM there should not be any 
daemons still running. 
10. After the i-ecjuired shutdowns, move the LOCAL_DA'rABASH 
from the temporary location to its permanent location. 

Note: Tliere are tu'o copies of eb_disaster_move. Be 
sure to use liie copy relative to the temporan," 
locaticjn of LOCAl,„DA']ABASE as sliown in tliese 
instructions. 

CAUTION: Do NOT use the copy in: 

/usr/ epoch/EB/ conf ig/ 

To do this, change to the temporary location: 
emc# cd /newpath/newdir/teinp_local_db 

Tlien find the patlt of the relative eb_disaster_move, cd to 
it and verify that you are there: 

eiric# find . -name eb_disaster_niove -print 
einc# cd <path containing eb_disaster_move> 
emc# pwd 

Move the LOCAL_DATABASE to its pennanent location by 
using eb_disaster_move: 
emc# . /eb_disaster_move 
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Note: Regarding use of duplicate volumes; 

Wlien eb_disaster_move completes, it automatically 
checks for failed and uncompleted ciuplicatkms. If a 
duplication failed, you must use the original volume 
for restore. If tlie duplication had not completed or 
was scheduled, at tlie lime the catalog was written 
to tape, the duplicate will be available for use. 

If the disaster occurred soon after ihe Imckup 
completed, these duplications may not have 
completed. If there are errors reponed during the 
restore while using the duplicate, use the original 
volume. If you do not have ilie original, contact 
Customer .Ser%'ice to restore from an earlier 
duplicate. 

After you have completed the disaster reco^'ery, 
rescJiedule the duplication of those original volumes 
that were not successfully duplicated. 

/nev;path/newdir/temp_local_db remains after 
eb_disaster_niove is done but is no longer 
needed. You may wish to delete it after 
completing all disaster recovery procedures. 

Any modifications to the eb.cfg file that were made after the 
LOCAL_DA'rABASE backup must be added manually to the 
restored eb.cfg file. You cannot restore any of the catalogs 
after the local_db backup (such as a new work item), until 
this is done. 

Note: If you want to use duplicate volumes that were 

made after the LOCAL_DATABASE backu]>, follow 
the instaictions in "Restore Catalogs and Backup 
Infomiation Created After LC)CA1._13ATABASE 
Backup" on page 20-23. 
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] 1 . Restart the following as shown: 

a. Restait the Volume Management daemon with tlie 
following command: 

emc# sh /usr/epooh/etc/rcS/SZOelm start 

b. Itestait ebfs witli the following command: 

emc# sh /usr/epooh/etc/rcS/S30ebf s start 

c. If you have an HSM system, reenable staging with the 
follo\A'ing command: 

emc# sh /usr/epoch/etc/roS/S40mal start 

You do not restart tlie ebcatalogd daemon at this time, It is 
restarted after you reboot the sen-er. See "Sto]^ Backups" on 
page 20-23. 

12. Eliminate any incomplete backups or catalogs that could 
confuse catalog processing. To do this, enter: 

einc# ebescpire -partial -purge -expire 

13. Ensure tliat all cacilogs that you just restored are in sync 
with the saveset database. To do tliis, enter: 

emc# ebcatclean -disaster 

Tliis completes the restore of the LOG AL_DA'l 'ABASE liacku]:) 
which contains tlie seiver catalogs and backup inlormation at 
the time of the last LOCAL_DATABASE backup. The LOCAL 
_DATABASE is no longer available (or needed) for the restore 
process. If you need it again, .start at step 6 on page 20-19. 

At this point, tlie ser\'er's library units are configured as they 
were at tlie time of the last LOCAL_DATABASE backup. If there 
were no significant events after the LOCAL_DATABASE backup 
(Step C in Figure 20-1 on page 20-2), enter ebcatalogd on the 
command line to restart tlie daemon and skip to "Restore Data 
Created Before LOCAL_DATABASE Backup'' on page 20-28. 
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Reconfigure Library Units For changes after the last LOCAL_DATABASE backup 

If any library units changed theii- configuration after liie 
L(]>CAL_DATABASE backup was generated (step € in l-'igure 
20-2 on page 20-3), use Imconiig to reconfigure them. 'Hiere is 
no information in the Disaster Report to assist you in tliis step, 
since these clianges (if they occuri'ed) happened after the 
Disaster Report was generated. 



Restore Catalogs and 
Backup Information 
Created After 
LOCAL_DATABASE Backup 



For changes after the last LOCAL_DATABASE backup 

If any of die events, such as D, E, F", or G in Eigure 20-2 on page 
20-3, occurred after your last LOCALJMIAIBASE backup, you 
siiould gel ilie catalogs and backup information back as soon as 
possible. 

Tliis applies, if you are using duplicate media which completed 
after the LOCAL_DA'n'y3ASE backup. 

To do this, you need to stop all backups, run a full inventoiy, 
import volumes, and then restore the catalogs and backup infor- 
mation. 



Stop Backups Disable backups by commenting out any ebbackup. ebexpire, 

and ebcatclean commands in the root crontab file. This needs 
to be done again because root crontab may have been modified 
when you moved LOG AL_DATA BASE from the temporaiy 
location to tlie permanent location. 

Rebocx the seiver with tlie following command: 
eiric# /usr/sbin/shutdown -y -i6 -gO 

This starts vmdaemon and ebcatalogd and makes all of your 
library units avaOable to use in the remaining restore process. 
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Run a Full Inventory and l . lak-e the box of tapes you set aside in step 2 on page 20-] 2 

Import Uncataloged Volumes and insert tlie tapes in llic library unit. 

2. Invcntoiy ilie contents of tlie library unit; 
emc# evminventory -1 at_dlt_452_0 -a -L 

Wliere -I = libraiy name, -a = all slots, and -L = Verify Label 

3. Then import all uncataloged volumes in the library unit, 
emcl evmimport -1 at_dlt_452_0 -a 

Wliere -1 = libraiy _name, -a = all slots (uncataloged only) 

4. \X'ait until the inventories complete before proceeding. 



Import Backup Catalogs and 
List Volumes 



Next import the current catalogs for the 
1 . To identify these, run ebreport media and select the most 
recent volume in the most recent rotation for each trail (as 
noted by a in the example in Figure 20-9). 

eiric* ebreport media 
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Figure 20-9 Output from ebreport media 

EDM Backup Media Report for server missile on May 9 14:22:22 1999 
Report options: none 



Rotations for Template "usr_bin", Trail "usr_bin_DLT" , Primary Trailset 
09/30/1998 12:54:42 Rotation ID: 4CD84987 . F6EECF8D. 00000200. 54028F30, 4 backups 

Media duplication used on 1 copy 
*Orig Vol: 60D84A1170094B3E (BNY574), Seq #: 000024 in TLU: at_dlt_3264_0, media: DLl 
Dup Vol: 73D8745E3E03B4A5 fBDE133) , Seq#: 000028 in TLU: at_dlt_3264_0, media: DLl 
Duplication State: Done, Successful, Duplication Date 05/08/1999 16: 06:0' 
Crig Vol: 4CDB4 967F6BECF8D (ASV891), Seq #: 000027 in TLU: at _dlt_452_0 , media: DL' 
Dup Vol: 96D8746209A96A9B (BDE128), Seo_#: 000031 in TLU: at_dlt_452_0, media: DL' 
Duplication State: Done, Successful, Duplication Date 05/08/1999 16:25:0' 



, Run ebimport lo import the backup catalogs and infor- 
mation irom tlie volumes tliat wei'e cun-ent a I the time of 
the last successful LOCAL_DA'l'ABASl: backup (identified by 
an ' in the output from ebreport media, as shown in the 
above example), 

lliese volumes may also contain appended l::)ackups not 
known at the time of the last LOCAL_DATABASE backup. 
(These volumes may reside inside or outside die libraiy 
units.) 

Note: lliis portion of the restore can take a considerable 
amount of lime because EDM Backup lias no record 
of the backups or the volumes on which they 
reside. 
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3. For each volume, run tlie following command to impon 
catalogs and backup information created after the time of 
tlie LOCAl,_DATABASE backup; 

emct ebiiaport -media valid -clevel 9 -level 9 

Some catelog imports may fail. If so. stop the Citlalog 

daemon and restart it with the 30 second option, whicli 

causes these catalogs to be processed again in 30 seconds 

rather than the default value of one day. 

emc# ebcatalogd -halt 

emct ebcatalogd -retrY_time 30 

If you make thus change you sliould reset ebcatalogd after 
com]5leiion of the disaster recovery. To do this, enter: 
emc# ebcatalogd -halt 

emci ebcatalogd -catalogs 3 >& /dev/null 

4. Execute the foUoNving command lo list all volumes in the 
library unit and their .states; 

emc# evmstat -v 

If there are any "uncataloged" volumes that are allocated after 
the last LOCAL_DATABASE backup, you must restore the 
catalogs and backup information. Otherwise skip to "Restore 
Data Created Before LOCAE_DATABASE Backup" on page 
20-28. 



Restore Catalogs and Backup l^esiore all catalogs and backup information that were created 
Information or changed and backed up, staged, or pan of a baseline backup 

after the LOCAL_DATABASE backup completed. (See 
Figure 20-2 on page 20-3.) This is restoring data from volumes 
that were allocated after the last LOCAL_DATABASE backup. 

Note: 'Ihis portion of the resttjre can also take a consid- 
erable amount of time. 
1. Run a dbreport volume, sort the output and redirect to a 
file as follows: 

emc# dbreport volume | sort > pre. sort 
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2. Use the EDM Library' Unit Manager window in the EDM 
GLT to import all uncataloged volumes, when a backup was 
appended to a previous baclaip after tlie 
LOC:a1._DATABASE was backed up. 

Note: If you are doing a parUal disasier recover}', and are 
sliipping over pt^rtions of tiiis cliapler, be sure tliat 
lire value of VM_ALLOW_DlIP_SEQJMPC)RT in 
/'usr/epoch/'eic/vnv'vm.cfg is set to "no," which is 
ilie default setting dial allows the ox^ei-writing of 
a duplicate sequence number. 

Look at which volumes are offline. Select all uncatalogued 
volumes and import them. When a message appears asking 
if you want to overwrite a duplicate sequence number, 
answer yes. Tliis makes the latest backup to diat trail 
available. 

.3. I?un another dbreixirt volume, this time I'edirecting the 
sorted output to post. soil: 

einct dbreport volume | sort > post. sort 

4. Run a diff on the two files: 

eitic# diff pre. sort post, sort 

Examine tlie output for volumes tliat changed from 
"available" to "allocated." The following is an example of 
diff output that shows an ER vc^lume that changed from 
"available" to "allocated:" 

media application voluirie_nairie sen side barcode state volid 



DLT EB Server_alt_DLT 147 0 00000327 available 2BC53BEA4 4E275B4 

DLT EB Server_alt__DLT 147 0 00000327 allocated 123456EA44E275B4 

The second column indicates which EDM application uses 
the volume. EB indicates EDM Backup, EM indicates an 
HSM volume, and baseline indicates a ba,seline backup. 
For EDM Backup volumes that changed, enter: 
emc# ebimport -media voJid -clevel 9 -level 9 
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For EM or baseline volumes that changed, enter: 
emcl ebfs_import -v valid 

Run ebcatalogd -status until it reports that all catalogs were 
processed. 

At this point, you have restored all of your most recent sen-er 
catalogs and backup information that were complete at tlie time 
of the last LOCAL_DATABASE backup and those completed 
after the last LOCAL_DATABASE backup. 



Restore Data Created 
Before LOCAL_DATABASE 
Backup 



You need to restore user files and some catalogs wliich were 
created before the LOCAL_DATABASE backup. 

Before you begin tliis section, restart the ebcatalogd daemon il' 
you did not do so in tlic previous section. To restart the 
daemon, enter the following command at tlie command line: 

# /-us r /epoch / EB/ conf ig /daeinon_s tar tup 

] . Use ebrestore with the overa'iire option set to nevei' to 
restore each seiver ^vork item you need to restore your 
fllesystems and partitions, and any customized operating 
system files such as /.login, /.cshrc, /.profile, network 
databases, and crontab files as they were at the time of the 
last LOCAL_DATABASE backup. 

# ebrestore -o never -i 

The -o never option ensures that you do not overwrite any 
files that you already restored, such as / and /usr which 
were reinstalled in Step 2 on page 20-6, Oveiwriting them 
may crash the system. 

CAUTION: You use the -o never option so that yovi do 
not restore all of / and /usr; since doing so 
may crash tlie system. For example, if you 
overwrite /usr/lib/libcso.l on a Solaris 
machine you crash the system. 

However, you may want to restore some 
specific individual files selectively with 
custom settings (such as /etc/hosts and 
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/etc/passwd) or programs loaded Into 
/usr/local or /usr/etc for local use using 
ebrestore with overwrite set to always. 

At this point, you should have restored all filesystems and parti- 
tions diat were present on tlie sender up to the last 
LOCAL_DAT.ABASE backup, (If you have an HSM system, EM 
and HSM now reattacli properly.) 
2. If an entire IISM VxFS filesystem was lost, you can do the 
following to restore their data quickly; 

a. Remount the filesystem without logging: 

erac# mount -F vxfs -o remount , nolog /homel 

b. Perfonn the restore using ebrestore or the EDM 
Restore window. 

c. Remount the filesystem w-ith logging when the restoj'e 
is complete: 

emcit mount -F vxfs -o remount, log /homel 

3- If you restored any system files, rel^oot die seiver. 

Note: Do not attein]3i multij^le restores From the sasne trail 
simultaneously. This slows dow'n the restores signif- 
icantly. 
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Reenable crontab Entries Reenable backups by undoing any edits you made to the root 
crontab file in "Disable Activity'" on page 20-5 or "Stop 
Backups" on page 20-23. 

If you do not want to restore past catalogs that allow you to 
restore older data, the recovery of the server is complete at this 
point. 



Restore Past Catalogs if you want to i-estore your earlier catalogs (which then allows 

you to resto]-e earlier backup data), continue with this section. 
These bacl\up catalogs preside a history ol" backups completed 
prior to the last LOCAL„DATABASE backup. 

You know which catalogs were not yet i-estored because 
ebreport lilstory may report savesets with ??????? in tlie 
Entries field. Tliis indicates that the catalogs for tiiose backups 
must be imported or restored before die backups ca n be 
r-estored. 

1. ILse ebrestore to r-e.store the r'&st of the backup catalogs. 
Set the overwrite option (-o) to never. 

emc# ebrestore -c emc -D emc -o never -d / -w emc:/data 
/data/epoch/EB/catalogs / 

In this case, emc:dala is the name of woiii item that backed 
up the partition on which the EDM Backup catalogs were 
stored, and /'emc/data/epoch/EB/ is whei-e the EDM 
Backup catalogs wei-e stored (see the example in 
Figure 20-5 on page 20-9). 

At this point you restoi-ed all of the backup catalogs up to 
the last LOCAL_DATABASE backup. 

2. Run ebexpire -partial -purge -expire to eliminate any 
incomplete backups or- catalogs that could confuse catalog 
pr'ocessing. 

3. Make sure all catalogs wei'e pi'ocessed. 
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a. Run ebcatproc -any to slan catalog processing lor 
these particular savesets. 

b. Run ebcatalogd -status. Continue wlien ebcatalogd 
j-eports riiat all catalogs were processed, 
ebcatalogd may indicate that some catalogs failed. If 
so, run ebcatalogd -halt lo stop the cauilog daemon 
and restart it with the -retry_liiiie 30 option, which 
causes these catalogs to be processed again in 30 
seconds ratlier than the default value of one day. 

If you make this change you should leset ebcatalogd 
after comp]eti(.)n of the disaster recovery. To do this, 
enter: 

eiTic# ebcatalogd -halt. 

erric# /usr/epoch/EB/conf ig/daemon_startup -ebcatalogd 

emc§ 

At this point, you restored the full EDM Backup catalog 
system (except for the most recent remote client catalogs 
which are discussed next). 
4. Now, you can restore any backed-iip data that was not 
present on tlie sen'er at the time of the LOCAL_r)ATABASE 
backup, by using the ebrestore -o never commanci. 
eiric# ebrestore -o never 
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Restore Missing Catalogs As a final step to restoring your data in a disaster situation you 
must make sure That you restored all of the missing baclcup 
catalogs. Tliese backup catalogs were neithei- backed up by tlie 
work item for the partition containing the catalogs nor were 
they pait of tlie LOCAL_DATABASE backup. 

1. To determine whicli catalogs were not backed up prior to 
tlie LOCAL_DATABASE backup, run the ebreport liistorj' 
command witli the -ebimport option. 

emc# ebreport history -ebimport 

This report displays ??????? in the Entries field if the 
saveset indicates the backup was complete but the catalog 
has not yet been restored. 

hi the example shown in Figure 20-10 on page 20-33, nine 
backups are missing tlieir catalog files. 

2. Identify the savesets that were not restored and impoit each 
one by using the followijig command: 

emc# ebimport -clevel 9 -level 9 -ok_if_unexpired savBset_id_l . . . 
saveset_i.d_n 

This restores the catalogs even if die saveset database 
indicates they are not yet expired. 
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Figure 20-10 



Output from ebreport history -ebimport 



11 3/98 20:56 0 5542FA53 . 2D28D220 ; 

SavesetlD ' 



7/ 3/97 0:56 0 554 2FA53 . 2C350E95 complete 7 
5/31/97 19:20 0 5542FA53 . 2C0A93DB complete 
**ltem "odie" 

Time Lvl ID Statu; 

6/14/97 21 : 31 C 5542FA53 . 2C1D2 6F6. complj 
5/i7/S7 19:40 D 5542FA53 . 2BF82217 complc 



Entries Expires 
! ??????? 6/14/90 
i ??????? 5/17/90 



Entrii 



7/16/97 23:31 0 5542FA53 . 2C4773D6 complete 

6/17/97 21:44 0 5542FA53 . 20211 F4 4 complete 

5/20/97 19:42 0 5542FR53 . 2BFC1 897 complete 

4/30/97 19:49 0 5542FR53 . 2BE1BBA0 complete 
Of the backups listed, 9 are missing catalog files. 
Those backups whose count of catalog entries are filled wich ' 



7/16/99 
6/17/9S 
5/20/99 
4/30/99 



; be i 



'ebxmj 



;overed until their catalogs have 
;_if_uriexpired" on the backup' 



For inibrmation on restoring a UNIX client see Chapter 21 
"Recovering a UNIX Client from Disk Failure." 
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Recovering a 
UNIX Client 
from Disk 
Failure 



lliis chapter contains disaster recovery procedures to use when 
you experience a disk crash on a UNIX client. Because each 
disaster is uniciue, these steps ai'e presented only as a guide and 
not as all-inclusive, step-by-step instmctions. 

CAUTION: Pei-foj-ming a disaster recovery requires 
experience with EDM Backup adminis- 
tration (and HSM administration, if you 
have tlie HSM option), UNIX system admin- 
istration, ajid the site environment. 

In general, to restore a lost EDM client, you must replace the 
damaged disk, reinstall Oie operating system, reinstall (or relink) 
to any lost EDM client software, and use the EDM Restore 
window to restore your lost files. 

If you also need to restore the backup serv^er, be sure to restore 
the server first, before you restore the client. Hie following 
procedures assume that the EDM Backup server is not damaged 
oi' was already restored. 

Note: This chapter applies to LINK clients. Refer to the 
appropriate client supplements ibr recovering other 
clients. 
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Recovering a Client Because you iDcrform all of the restore in multiuser mode, you 

must notify the user community? to stop all aciivit\f on the client. 
No one should be able to log in. The client must be inacli\'e 
before you peifonn any disaster recovery procedures. 

'I'lte following pi'ocedures also assume tliat all of the client 
filesystems are damaged or unavailable. If some filesystems 
remain intact, you might be able to skip some steps, These are 
guidelines only. 



Beginning StSpS To restore an EDM client in case of a disk crash or major loss of 

files: 

1. Edit root's crontab file on the server to comment out all 
backup and staging coiiiraands that might start up automat- 
ically. Comment out the follcm'ing entJ-ies (note that some 
are HSM-spccific (begin with em) and apply only to EDM 
Migration clients): 

00 0 * * /bin/kill -1 'cat /usr/epoch/etc/mal/emmasterd.pid- >/dev/null 
2>fil#EPCmalc 

15 23 * * -* /usr/epoch/bin/emvck >/dev/null 2>il#EPCmalc 

00 1 * * * /usr/epoch/bin/eracompact -c >/dev/null 2>&l#EPCmalc 

00 2 * /usr/epoch/bin/emscheck >/dev/null 2> &l#EPCmalc 

00 3 * ■* * /usr/epoch/bm/emsundel >/dev/null 2>61#EPCmalc 

00 18 * * * /usr/epcch/EB/bin/ebbackup default >/dev/riull 2>sl HEPCebs 

00 11 * * * /usr/epoch/EB/bin/ebexpire -expire -purge >/dev/nuIl 2><,1 #EPCebs 

00 1 ■* * * /usr/epoch/EB./bin/ebcatclean -fix_saveset >/dev/null 2>&1 #EPCebs 

00 3 * * * /usr/epoch/EB/corif ig/local_db___warning >/dev/null 2>s,l #EFCebs 
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2. Clieck hardwai'C and replace ii" necessary. Run a disk 
diagnostics program. Re sure to identify and replace all 
damaged hardware before peiforming any sofWare 
recovery procedures. Make sure replacement hardware is 
fully compatible with the system you had before the 
disaster. Each new disk .should have at least the same 
storage capacity as the old disk. 

3. Reinstall the client's native opej-ating system. For directions, 
see the documentation that is supplied with the client. This 
reinstall process partitions your disk, restores the root 
file.syslem on the client, and restores that ponioji of /usr that 
the operating system loads. Make sure lo specify tliat these 
filesystems are at least as large as and have the satne (or 
larger) number of inodes as tlrey had befoj'e liie disaster. 

CAUTION: Do not continue with software recovery 
until you are absolutely certain the disls is 
free of hardware problems. 

If you are recovering a Backu],5 client, go lo step 6. 
If you are recovering an HSM client, go to step 4. 



For HSM Clients Only 4. if the client is an EDM Migration client, reinsuill VERITAS 

VxFS filesystems. Customer Service has the Software fnstal- 
lalion manual, call tliem witli questions. 

Go to step 6. 
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For Backup and HSM Clients 5. Keinsal] the EDM Backup software using 

eb_install_client. Reconfigure EDM Backup on tlie client, 
using exactly the same settings as tliose defined prior to the 
disaster. 

Refer to the iiill ebreport disaster report as necessary, for 
a list of the workitems prior to the disaster. 

CAUTION: Do not restore all of / and /usr; doing so 
may crash the system. Only restore those 
files tliat contain customized settings; for 
example, /etc/hosts and /etc/passwd, or 
programs that are loaded into /usr/local or 
/usr/etc for local use, 

6. Create and mount new, empty filesysteins that are identical 
to (in terms of ntiniber of blocks and inodes), or larger 
than, those on tlie client before die disaster. Note tlial the 
commands used and command syntax vaiy fi'om platform 
to platlbmi. For a Sun workstation, for example, use newfs, 
mkdir, and mount. Refer to tlie ebreport installation or 
a full ebreport disaster report for a list of client filesystems 
and their sizes prior to the disa.ster 

7. If tlie ftlesystem that contained the backup softwai'e is still 
intact, but /mr was destroyed, you need to recreate the 
symbolic link from Aisr pointing to this filesystem tliat 
contains the backup software. 

If you are recovering a Backup client, go directly to step 12. 
If you are recovering an HSM client, go to the next section, "For 
FISM Clients". 
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For HSM Clients when recovering an HSM client, verify whetlier ilie EDxVl 

sollware (/ep_usr) is damaged, 

• If il is not damaged, use the ibllowing steps in this order: 
step 9., on page 21-5 step 10., on page 21-5 and step 5.. on 
page 21-4 

• Jf il is damaged, use the ibllowing steps in this order: step 
8., on page 21-5 step 10., on page 21-5 step 5., on page 21- 
4 step 11., on page 21-5 and then step 9., on page 21-5 

8. Reinsuill the EDM Migration (mc) software using 
ep_install. 

9. Run emlsconf to display the old configuration. Any newly- 
created filesystems must be reconfigured lor migration even 
if the MM database files look intact. The commands are: 

# emlsconf -r filesystein 

it emfsconf filesystem old_parameters 

where oldjMrameteis are die emfsconf parameters 
displayed by die emlsconf command. 

10. Sliut down the HSM daemons prior to restoring the EDM 
software filesystem; 

emct sh .usr/epoch/etc/rcK/KeOmal stop 

11. ]iesto]-e the filesystem whei-e tlie EDM softwa]-e was 
installed (/usr/epocl^'etc) out of place, and then move it to 
die proper location (/usr/epoch) to bring back the database 
files. Then reboot the migration client. 

1 2. If you have an EDM database client, reinstall the vendor 
database software, if needed, via theii" insti'uctions. 'llien 
reinstall the Backup software, if needed. I'or offline 
dataliase backup and Oracle online backup, you can do this 
through die EDM Backup Configuration window. For eariier 
online backup clients, see the appropriate online backup 
supplement and release notes. 



EDM Software Reference 



21-6 



Recovering a UNIX Client from Disk Failure 



For Both Backup and HSM 
Clients 



Alter you reinstell llie EDM Backup software using 
eb_install_clleiit, you are ready actually to restoi e your files. 
13. Open the EDM Restore window: 



- from the client using; 



client 1# ediBcrestore 



or 



- fi-om the EDM Main window. 

Use tlie EDM Restore window or ebcrecover to restore 
your lost fllesystem.s and files. In the EDM Restore \A'indow 
you can browse a list of w'ork items for the client, select the 
w-ork item, mark the files you want to restore, and stan the 
restore. 

14. Reboot the client system. 
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A Directory 
Structure 



This appendix describes the directory sliaicture of EMC Data 
Manager backup, volume management, and USM. 

This is the directoiy structure of the sofware that mns on a 
server and the sofl"v.'are that ams on the client, which enables 
the client to collect backup data and restore recovered files. 

Iliis appendix desciibes the following: 

• Backup Server Director)' Structure 

• Backup Client Directoiy Structure 

• Volume Management Directoiy Stiiicture 

• HSM Directoiy Structure 
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Backup Server Directory The EDM backup server software handles all aspects of backup 
Structure and restore operations. Its components are: 

• EDM n-ansfei- pixitocol c;r remote shell (rsh) - Communi- 
cation between die server and client. Tlie EDM ti-ansfei' 
protocol is supponed on UNIX platforms. 

• EDM Backup sei'ver pi'ocesses - Daemons and programs 
thai service backup and restore opei-ations. 

• The Global Configuration Database - Configuration 
specifications that direct backup and restore operations and 
files that manage the database. 

• The Installation Dii-ectoiy - Dii-ector\- on the EDM server 
that contains backup inslalkiiion and executable files for 
both the .sen'er and tlie client systems. 'litis section 
describes backup by looking at the elements on the servei- 
that operate the backup and restore operations. 

EDM stores two sets of files on the server: large and small. The 
set of large files (backup catalogs and log files) grows over- time 
and the set of small files (client binaries and configuration files) 
does not. 



/USr/cpOCh The /usr/epoch directory includes several subdirectories that 

contain configuration and database files. 

CAUTION: Although these files are text files, you 

should never attempt to modify them with 
an ordinary editor. The configuration 
commands and the EDM Backup Configu- 
ration window do more than just modify 
the files. 

Figure A-1 .shows many of the top-level directories. 
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Figure A-1 



Server Directory Structure (/usr/epoch) 



/usr/epoch 



a dm 



doc 



fifos 



install 



lib 



tmp 



bin 



etc 



gui internal locks 




sample 



• adm - location for circular and archived log files 
» bin - contains user executable binaries 

• doc - contains online documentation 

• etc - contains vital EDM software databases 

• fifos - EDM software fifos 

• gui - gui resource files 

• install - contains non user executable install files 

• interna] - contains EDM internal commands 

• lib - contains shared libraries and non user executable 
daemons (linked to from /iisr/epoch/etc/lm) 

• locks - contains lock files 

• man - contains all man pages 

• sample - contains sample \blume Manager and Lilirary 
Manager configuradon files 

" tmp - EDM software tmp directory 
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/USr/epOCh/EB The next level of backup server directoi'ies, /usr/epoch/EB. 

contains the following sulxiirectories. 



Figure A-2 Server Directory Structure (/usr/epocli/EB) 




• bin - contains the server executables 

• catalogs - contains the backup catalogs and the saveset 
database (ebsaveset_db) 

• client - contains client executables and installation files 

» config - contains the configuration files, including eb.cfg 

• db - contains database files; for example, cattask.list and 
htab 

• locks - contains lock files: for example, ebcatalogd.lock 

• log - contains the backup log files 

• preconfig - contains a file for each client with default 
configuration information 

When you initially configure backup using eb_server_config, 
you can create the directoi-y /usr/epocli/GENDlR/EB to hold 
large catalogs and log files, 



EDM Software Reference 



Backup Server Directory Structure 



If you run eb_server_config without the -D option, )'ou ai'e 
prompted to create the alterjiate directories. eb_sen'er_config 
also creates the following symbolic links (symlinks): 

• /usr/ejDOch/EB/catalogs is a symlink to 
/usr/epoch/GENDlR/EB/catalogs 

• /usr/epoch/EB/log is a symlink to 
/usr/epoch/GENDlR/EB/log 

Refei" to the eb_server_config man page for more information. 



The bin directoiy contains all the server binaries and a 
VERSION file diat contains the current \'ersion ol' EDM Backup 
software and a HISTORY file that contains a history of all EDM 
Backup installations. 



The bin Directory 



/usr/epoch/EB 




The catalogs directory contains tlie saveset database and one 
tiirectoiy for each configured work item. Tliis subdirecloiy has 
the same name as the woi'k items and is created as neces.sar)' hy 
the catalog subsystem. Any "/" cliaracters in the work item's 
name are translated to characters for use in directoiy and 
filenames. 
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Below the work item directon' are DATE directories. DATE 
directories are named with four-year digits followed by a dash 
and the month digits (for example, 1998-02). Hie catalog 
sofiTA'-are must be able to create a date directory when it writes a 
new backup catalog. 

The puipose of this directory structure is to enable system 
administrators and customer support personnel to scan 
directories of moderate size for catalog files, while allowing the 
software a simple and fast algorithm for locating catalogs. 



Figure A-4 The catalogs Directory 



/usr/epoch/EB 


symlinK^ 



/usr/epoch/GENDIR/EB/cataiogs 
ebsaveset_db ) work item work i 



I h date directory f-i 



Client Directory The client directc^ry contains binaries and other client platform- 

specific software. Under this directory are client platform 
directories of the form: 
manufacturer_cpu_o^^ ^otheil 

The _olher suffix is optional. It is used for anytliing that does 
not fit into the scheme of manufacturer, cpu, and OS. jNormally, 
it is not used. Client platform directories have names .such as 
sun_sun4_v5 or hp_800_vl0. 
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The client directory also contains a subdirectory called generic. 
This subdirectory (as well as each of the platform subdirec- 
tories) contains a bin subdirectoiy, which contains up to two 
files that are used in customizing the client installation process. 
The file that is shipped as part of the backup software distri- 
bution package is named eb_ci_parciculars. The second file is 
generated from die first and is named eb_ci_data. The fo!lov,ang 
describes each file: 
• eb_ci_particulars file - Contains definitions set by EDM for 

constants that should not have to be changed at your .site 

(such as the name of the platform-specific options to be 

used with the iniilpts command). 
" eb_ci_data file - Contains the generic platform's constants. 

Tliis file is c]-eated during backup installation for each 

platform type under /usr/epoch/EB/ client. 

Under each specific client platform directoiy are the sufjdi- 
rectoiy, bin and optionally, the subdirectory maji. Tire bin 
directory contains all client scripts and binaries for installation 
of the client as well as those for the normal backup operation of 
the client. Like the bin subdirectory under generic, these bin 
directories may also contain the eb_ci_particulars file. In all 
cases this subdirectory contains tire eb_ci_data file. Tire man 
directoiy contains man pages for the client recovery prognmits). 
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The client Directory 




Confjg Directory The config dlrectoiy contains the default eb.cfg configuration 

file, sample configuration files, and a sample fiiidxcpio macro 
file, called defines.cfg. It also contains a file called 
clientsjnstalled which is modified when each client is installed. 
It includes the mailok script to which tine backujT soltware 
passes backup completion repons, and the mailerr script to 
which it passes backup failure reports. 



Figure A-6 The config Directory 



/Usr/epoch/EB 




mailerr 
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If you installed backup lo backup all (oi- some) clients by using 
the autoconfig facilit\% this directory also contains a default 
configuration file for eadi such client (/config/c//e»?- 
rwme/dcfg), and an autoconfig.cfg file. Tliis autoconfig.cfg file 
references llie default (dcfg) file for each client, via an 
#1NCLIJDE, and provides a single work-group definition for the 
auto_configured_work_group. You can flien create a temj^late 
that references that work item and thus backs up all the 
autoconfigured clients at once. 



Db Directory The db dii-ectory contains the EDM backup database files. 



Figure A-7 The db Directory 




ci_ac is a subdirectory that contains information that is used 
by recover's graphical user interface. It stores information 
similar to that in the preconfig directory but is more tuned 
toward graphical standards. 

ci_data is a subdirectory that stores the installation param- 
eters for each client machine, 'lliese parameters describe 
what occun-ed during the most recent client installation. 
One file in tliis subdirectory exists for each machine 
installed, and it is named after tlie machine: 
/usr/epoch/EB/config/'db/'ci_data/c/fe»/-».<3??ie. 
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• cm is a subdirectory that contains all of the information that 
the coverage report uses. 

• cattask.list is ebcatalogd's database file. It contains all of 
tlie infomiation that is needed to process the catalogs tliat 
ebbackup generates. 

• htab lists and identifies all of the installed clients. 

• todo.list is ebbackup's database file. It contains all of the 
backup history, including when the backups occurred, how 
long they look, the old and current .schedules, etc. 

The following files exist only on an HSM system: 
» ebsbvol.list (the savesei-to-baseline relations file) is used for 
baseline backups (levels Bl and B2). For each physical 
volume that is used in a baseline backup, this dataliase 
records the volume ID and saveset ID of llie backup. 
» ebmtag.list maps work item names to EpochMigration tags. 



Locks Directory The locks directoiy contains lock files, for example, ebcat- 

alogd.lock and a lock file for each work item, This directoiy is 
flat; no subdirectories exist under locks. 



L09 Directory l^he log directoi-y (which may contain a symbolic link to 

/usr/e]ooch/GENDlR/EB//logs) contains all of the EDM backup 
logs files. For more iiii'orniation on log files, see page 16-35. 



PreCOnfig Directory The preconfig directory contains a file for each client. This file 

contains default configuration information for die client. 



Server Man Directory The sen'er man pages are installed in Aisr/epoch/man. 

For a listing of both server and client man pages, see Chapter 18 
"Man Page Listing". 
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Backup 


Server Directory Structure 


Table of Backup Server 
Directories and Files 


Table A-1 desmbes each of the sen'er's configuraiion files. 


Table A-1 


The Server's Configuration Directory 




File or Directory Name 


Description 




/usr/epoch/EB 


Contains die sen'er's EB directories and files. 




Aisr/epoclx/EB/bin 


Contains the sen'er's binaries. 




/usr/epoch/EB/'l3in/VEi?SI0N 


Contains the cui'j-ent installed EDM backup version 




/usr/epcxii/EB/bin/HlSl"Oin- 


Contains the EDM backup installation history, 




/nsr/epoch/EB/catalogs 


May contain a syml^olic link to the backup catalog direcioiy on tlie EDM 
iDackiip sen'er; /usr/epoch/GENDlR/EB/catalogs 




This stores tlie bacl<up catalogs. 




/usr/epoch/EB/cHent 


Contains all client installation files. Contains a .subdii-ecton," for each 
platform manufacturer, CPU archiiectui-e, and OS re\'ision sup]>orted for 
EDM backup clients. 


/usr/epoclvEB 

/cl i eni/ man iif_cpi i_os 


Describes the platform manufacturer, CPU architec 
Each stibdir-ectoiy name is of the fomiat: manufact 
sun_siin4_v5). This directoi'v is not used until the ' 
procedure is perFornied, 


rure, and OS revision. 
u)-er cpu OS (e.g.. 
client installation 


/usi-/epoch/EB 


Contains platfomi manuf'actui'er client bitiaries. 




/usr/'epoclv'EB 

/c\\er\l/manuf_cpu_os/mm 


Contains the client man pages. 




/usr/epoch/EB/client/generic/bin 


Contains binaries that arc used to customize clieni 


installations. 


/usr/epoch/EB/config 


Contains the EDM backup configuration files. 




/usr/epoch/EB 

/config^auloconfig.cfg 


Contains information used by autoconfig to define the 
auto_configured_work_group, and to reference tlie default configuration 
file lor each autoconfig client. 


/iisr/epocli/EB 

/covAg/' client-name! Mg 


Describes the configuration for each client that is 
autoconfig facility. 


jjacked up via the 
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The Server's Configuration Directory (Continued) 



File or Directory Name 

/iisj/epocli/HB/ 

config/'clientsjnstalled 

/usr/eiooch/EB/config,.'defines.rtg 

/usr/epoch/HB/config/'ma i leiT 

/ u sr/epoch/EB/'con Rg/ma i lok 

/usr/cpocli/EB/config/samples 

/usi-/ep(jch/'EB/config/eb.dg 



/usr/epodi/EB 

/ confi g/l oc a 1_ cib_sia rru p 

/iisr/epocli/EB 

/config/locaLdti_cle:mup 

/usiyepoch/EB 

/'config/local_db_wa m i ng 

/usr/epoch/EB/db 

/usr/epoch/EB/db/ci_ac 

/usiyepoch/EB/db/ci_data 

/'iisr/epoch/EB/dlj/cm 

/iiS!/'epoch,/EB/db/el3mtag.l)si 

/usi-/epoch/EB/'db/'todo.list 

/u,sr/epoch/E.B/db/el3sbvo].li.st 



Cunlains an entry For eacli EDM backup clieni insialJed. ^'oii can read biil 
not edit this file. 

Contains a sample finclxcpio macro file. 

Contains the script to which the Ijackup software passes baclaip failure 
reports. 

Contains the script to which the backup software passes backup 
completion reports. 

Contaijis samj^Ie configuration files to use as a rcfej-cnce when editing 
the eb.clg file. 

Contains the sen-er configuration file. You edit this file by way of the 
EDM Backup Configuration window to specify- the sen er's configuration 
information. 

Dictates what get.s backed up by the f.OCAl,_.D.A')ABAS]': backujx 

Dictates what happens after the LOCAL_D ATA BASE liackiip is done. 

Mails a warning message to the adminisirators if the LOCAl._DATABASE 
backup is too old. 

Contains ebbackup's database files. 

Contains information used by the EDM Restore window. 

Stores the installation parameters describmg what took ]3lace during the 
most recent in.stallation of each client inachine. 

Contains all the inform 

Maps woi'k item name 



Dn used by the coverage report. 
) EDM Migration tags. 



Contains all the backup history (when backups occurred, how long they 
took, schedules, etc.). 



Stores the volume id(,s) and si 



1 ID for each baseline backup. 
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The Server's Configuration Directory (Continued) 



File or Directory Name 



/usr/epoc)i/EB/db/canask.list 
Aisr/epocii/EB/locks 

/usr/epoch/'EB/log 



needed to process ihe catalogs generated by the 



Contains all inf' 
backup sotnvari 

t;ontains all of the temporaiy loclv files that the backup software creates 
during backup and restore operations. This includes locks on templates 
and irailsets. 

May contain a symlink to the log file directon- on the EDM backup 
seiYer; /usr/epoch/GENDIR/EB/logs 



;r/ep och/ E B/ p re confi g 
;r/epocli/'man 



Contains a file for each client; each file contains default configui 
information for the client. 



jries for the man pages. 



Backup Client Directory 
Structure 



All backup files on the baclaip client ai-e stoi-ed in tlie bacloip 
client's home directory. 

'I'he examples in tliis document specify the name of tlie default 
user, ebadmin. The home directory is specified as -ebadmin. 

Note: ]'or security purposes, ebadmin shcnild not hiwv a 
password, and a user should not be able to log in. 
The backup sofWare creates the dei'ault user name 
with no password. (Refer to "Security Issues'" 
below.) 



Client Home Directory The goal of the client installation prcx:eduj-e is to set up the 

backup client home director)' as shown below. Assuming that 
you used the default backup client username ebadmin, the 
home directory is -ebadmin. You can have a separate backup 
client home directoiy on eacli client system or you can specif)' 
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one directoiy thai all the clients mount via NTS^ Tlie direcioiy 
su-uctiii-e allows Uiis type of sharing, althougli it does not allow 
one client lo be backed up by multiple EDM imiis. 



The -ebadmin Directory 



-ebadmin 




Under the home dij-ectoiy there is a subdirectoiy for each client, 
named with the client's network host name. The client directory 
contains the bin directoiy which holds all the client binaries as 
well as a \TRSION directoiy that displays the vei-sions of the 
binaries. The client directoiy also ccmtains the backups and 
recoveries log files (for more information, see "Log Files" on 
page 16-35) and a HISTORY file tliat displays each client instal- 
lation. 

In tlic case \vhere many clients share the same platfomi and OS 
release, installing binaries in each client's home directory is 
redundant. Thus, you can replace a bin directoiy with a 
symbolic link to a bin directory of anotlier client of the same 
type. You must do this manually (it is not done during instal- 
lation). 

If you rein.stall or deinstall a client, tlie existing bin directoiy is 
removed. Ilius, any clients that have links lo that directoiy are 
not backed up. 
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SBCUrity Issues a potential secm-irs' hole exists for backup client directories that 

are shared via NFS by more than one client. For example, 
consider two clients, client! and client2, that share the same 
backup client home directoiy. Call the backup client user 
ebadmin and this home director)' -ebadmin. In this case, 
someone who is logged in as root on clientl can go into the 
-ebadmin directoiy on clientl and change its .rhosts file to 
allow access to die directoiy as ebadmin from clientl (normally 
access is only allowed from the RDM), He or she can then 
contact client2 as ebadmin from clientl and cause client2 to 
perform backups of any file on client2 and send tlie output to 
clientl. Furthermore, the bacloip data can then be manipulated 
on clientl and .sent back to client2 as a restore so as to 
overwrite existing files on clienl2. 

Note: If this type of security is of concern to you, do not 
share client backup iiome directories via NFS. 



Additional Client Software llie default location for -ebadmin is 

/usr/epoch/EB/(:Ln5;N'r_FIOME. 

Some of the other client directoiies are listed in Figure A-9. 



Figure A-9 Client Directory Structure 




CLIENT_HOME | 
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• liB - contains the client home direciory (-ebadmin) 
" EB_DB - holds diitabase backups 

• bin - contains report and restore scripts 
» man - contains client man pages 



Client EB_DB Directory Eacli installed client gets the /usr/epoch/EBj:>B direcioiy 

which holds database backups. 



Client bin Directory You cm also install scripts on selected clients foi- client file self- 

recoven* and report generation. By default, tlie scripts are 
installed in /usr/epoch/bin. You can also install the scripts in an 
alternate directory. 



Figure A-10 The Client bin Directory 




Client man Directory You can choose to install the client man pages in either 

/usr/epoch/nian, /usr/local/man, or in a location oi'your 
choice. 

l or a listing of both sen-er and client man pages, see Chapter 18 
"Man Page I.t.sting". 
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Table of Backup Client 

Directories and Files 


Table A-2 describes tliese client files and directories. 


Table A-2 


Client Directories 


File or Directory Name 


Description 


-ebadinin (/usr/epoch/EB/CLlEN'IL^ 


I10.ME) Default client home directoiy that contains a siii3direciory foj- each 
client, named will) the client network host name, 


~ehiidmin/d ieiii-namo/b\ n 


All client binaries for the client are stored liere together with a 
VERSION directoiy showing the vej'sion of these liinai ies. 

I'he bin subdirecion' can he a symbolic link to the bin subdi- 
rectojy of another client with the same architecture and OS. 


-ebadmi iVclien l-iwrne/VW STO RY 


mS'J'ORY file shows each installation that is performed for the 
client. 


-tb-A d mi n/clien t-n ame/ba ckiips . log 


Client's backups.log file records critical information about backups 
performed on this client, 


-ebadmi ii/c//«??-r(<3n?e/l3ackups. log. 


cminfo Contains covo'age monitor data diat is sent to the sen'er after each 
backup. 


~ebadmin/c-//(?«?-?!fln?p/jeco\'eries.k; 


ig Client's recoveries.log file records information about file restores 
that are performed on this client. 


~ebMmm/client-mme/eb_ci_chna 


Contains shell script values that are reqiiii'ed by various shell 
scripts such as startfuid. 


/iisr/epocli/man or /usr/locai/jnan ( 
an alternate direciory) 


or Contains the client's man pages. 


/usr/epoclv'bin/ebcreport 


Enables netv^'orked clients to prodticc rej^oris such as media and 
backup history reports. (See man page.) 


/ usr/e]D och/b i n/ebci-e cov er 


Allows a networked client to restore files, directories, and 
filesystems. (See man page.) 


/usr/epoch/bin/edmci-estore 


Starts the EMC fJata Manager Restore window from a netwoi ked 


/usr/epoch/EB_DB 


Contains files for backups of database files. 
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Volume Management -J-he /usr/epoch/etc directory has many subdirectories that 

Directory Structure contain vltal EDM software database files. Two of iliese are the 

Library Manager and Vblurnc Manager files. Figure A-11 shows 
tliese two subdirectories of /usr/ epoch/ etc. 



Figure A-11 



/usr/epoch/etc Directory 



Im name 1 



Library Manager Each Library Manager resides in an individual subdirectoiy in 

Subdirectories /usr/epoch/etc/lm. For more information, see "Library Manager 

Configuration Files" on page C-9. Tlie directoiy name matclies 
the Library Manager name that appears in the Display area of 
the main volume management window. 

Within each Library Manager directoiy, Imconfig creates 
several files. During start-up, the Library Manager ]-eads the files 
in its directoiy to initialize the libraiy unit it is managing and to 
set up its internal data strucaires. Table A-3 describes the files 
that are located in each of the Library Manager directoiies. 
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Table A-3 




Files in /usr/epoch/etc/lm///n_name 


File 


Description 





Configuration file for the !Jbrar\' Manager, l.il^raiy Manager conflgui'ation includes param- 
eters that define tlie hardware address (SCSI bus, target 115, and lun) of the device, IJbrary 
Manager name, number of drives, and scheduling parameters for the lobot and drivel's). 
See "Libraiy Manager Configuration Files'' on page C-9. 

in\'eniory list o( the libraiy unit's contents, This file enables the Libi'ary Manager to stan up 
without taking a complete inventoiy of the library unit, lfvolid.dat does not exist, the 
Library Manage!' inventories the library unit and creates the file, 'fhe Libraiy .\'fanager 
updates the volid.dai file when it: 



• enables or disables a library' unit slot 

• takes an inventoiy of the libraiy unit 

d » Soft link to the physical name of the drive that is located in /devices, ri indicates the diive 

number. 

lm_ln_drive_??,dal Drive contents file lor each drive in.stalled in the library unit; where n indicates the drive 
numl>er. 

clog (jrcular log file that contains a detailed description of the activity for this Libraiy Manager. 

Imd Link to the Libraiy Manager executable daemon located in /visr/epoch./lib/'n'ni. 

liblin_tnumber Contains a number used internally to identify the Libraiy Manage]-. 
lm_is_open Lock file that ensures that only one copy of the Libraiy Manager daemon is iiinning at one 
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Volume Manager Files 



'["he dii-ectory /iisr/e]Doclvetc/vm contains all files that are 
related ro the Volume Manage]'. Foi- more information, see 
"Volume Manager Configuration File^' on page C-2. Table A-4 
describes the files tliat are contained in /'usr/'epoch/etc/vm. 



Files in /usr/epoch/etc/vm 



File Name 

clog 



notd.pid 
notd_clog 



iemplaies 
[emplates.del' 
lemplates.templateid.ndx 
vm.cfg 



vm_is_open 

x'mdaemon 

vmerd 

volumes 
volumes. def 
volumes.volid.ndx 



Description 

X'olume Managei- daemon's circulai' log (clog) file. An ascii file tliat sen-es as 
H debug Jog and contains a detailed description of the vmdaemon's aciivity. 

Link- to the notif 

Koiify daemon's process ID file. 

Notify daemon's circular log (clog) file. An ascii file that seives as a debug 
log for the notify deamon. It contains a detailed desaiption of ilie noid's 
activity. 



n located in /usr/epoch./lib./n'm. 



mplates for labeling 11 



'l emplate catalog contains vi 
Template record definition file. 
Template index file. 

Volume Manager configuration file. This file contains parameters thai define 
the location of the vmdaemon, set the message-logging level, and lists tJte 
Library IVlanagers configured for this seiver. See "Volume .Manager Configu- 
ration I'ile" on page C-2. 



Lock file which prevei 



o Volume A-lanager daemons from running at c 
able daemon that is located in 



Link to the Volume Manager 
Aisr/cpoch/bin. 

Link to the Volume Manager's erasing daemon that is located in 
/usiv'epoclvfib/rvm. 

Volume catalog, contains complete volume information foi- the server 
'I'emplate catalog contains volume templates for lal'jeling media. 
Template index file: an internal file used exclusively by the vmdaemon, 
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HSM Directory Structure The /usr/epoclv'etc/nial directory includes several subdirec- 
tories which contain server and client configuration and 
database files. Hiis section provides detailed infoi'mation on this 
directoiy strucaire. 



HSM Configuration Database F.veiy EDM HSM server and ever\^ migration client contains a 
migration configuration database. This database consists of 
structured text files tliat are updated i3y tlie emstconf 
emfsconf, and emsysconf commands and by the iimctions 
you perlbnn when using the EDM HSM Configuration window. 

The database contains information that specifies which 
filesystems are stageable, when files should be staged, and the 
staging templates to wliich filesystems are assigned. 

CAUTION: Although these fdes are text files, you 

should never attempt to modify them with 
an ordinar>' editor. Tlie configuration 
commands and the EDM Backup Configu- 
ration window do more than just modify 
die files; they also know how to interact 
correctly with any string processes that 
are running. 

On client systems, llie database also lists ihe fileserver and store 
to which staging templates are assigned. 

The text files are stored in the /usr/epoclVeic/mal/' directory. 
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Figure A-12 



Configuration Database 




Migration Database Flies 



Text file tliat contains system- 
emsysconf command or win 
Interface. 



configuration data. You update tliis file with the 
u cliange global properties with the Configui'ation 



'I'ext file ilKit contains staging template configuration data. You update tliis file with the 
emstconf command or when you change .staging template infoniiation with the 
Configuration interface, 

Text file that contains client store information. You update this file with the emstconf 
command or when you change store information with the Configuration InterJace. 

Text file that contains per-filesysiem configuration data. You update this file when you 
issue the emfsconf contmand or when you change ftlesystem infomiation with the 
Configuration interface. 

Text file that contains tjaseline backup information. This data is tnanipulaied by the HSM 
sofiwai e on behalf of the backup software. 



Network HSM Server Database The network migration sen-er has a global configuration 

database that contains information about neTO'oii< migi-ation 
activitN' and tlie defauh client store values. Tlie glol:>al configu- 
ration database files reside in /usr,/epoch./'etc/mal. 

CAUTION: Editing these files directly may result in loss 
of data. 
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HSM Directory Structure 



Altlioiigli both the einsd_conf_db and the emsd_store_dl3 files 
contain editable text descriptions of the configuration, do not 
edit these files directly. Instead use the sen'er's configuration 
commands or the EDM Backup Configuration window to make 
any modifications to the database. Thei-e are five cLitabase files. 



Figure A-13 


Global Database Files 

/usr/epoch/etc/mal 


(^msd_ 


_conf_^]) (emsd_£tor^_^^ ([^^^^^^ernsd_info^^ ([[^^^^emsd^tats^ ([^^^^^emsd^a^^^ 


Table A-6 


Global Database Files 


File 


Description 


enisd_conLdl3 


Text file thai defines the limits on the HSM software protocol requests and the detault 
values for client store configurations. 


emsd_inro 


Binaiy file that contains information about the cunently executing enisd process. 


emsd_store_db 


Text file \\ ilh a list of configured clicni stores and their locations on the server. 


emsd^stats 


Binaiy file thai contains cumulative statistics on HSM software protocol traffic and client 
agent activity. 


emsd_data 


Binar>' file that contains the ITSM usage histoiy on the seiver. 



Client Stores Eacli client store has its own file hierarchy and is logically 

independent from eveiy other client store. The client store's 
top-level direcloiy contains three files and two subdirectories. 

As system administrator you see these files and directories v^'hen 
you list tlie contents of the client store directoty. 
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Direclory Structure 



Figure A-14 Client Store Organization 




The client si:ore's top-level files and directories are listed in 
Table A-7. 



Table A-7 Client Store Files and Directories 



File/Directory 


Description 








store_conf_db 


Text file of the stores 


configuration informatior 






siore^state^db 


Text file of the store's 


state information that the 


• ciie-nt agent keeps current. 






List of xhe liirfiles to n 


fstore from the EI3M sen- 


er's backups. 




new„J:iitfi]es 


Temporan' holding di 


rectoiy for bitfiles iliat are 


■ being ci'eated as j^art of a stage ou 


I Jrom 


bitfiles 


Dii-ector)' tliat contain 


s the completed i^itfiles ir 


1 a 3-level hierarchy. 





When the client agent creates a bitfile, it gives tiie bitfile a U> 
digit hexadecimal name and places it in the new_biifiles 
directory. The bitfile remains there iinvil it is completely s^'ritten. 
Once the bitfile is complete, the client agent mo\'es it to the 
bitfiles directory. 
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HSM Directory Structure 



Bitfiles reside at the bottom layer of a directoiT hieiarchv as 
shown in Figure A-15. Bitfile names are l6-digil hexadecimal 
numbers representing the lower 64-bits of a file's bitfile ID. ('Hie 
bitfile ID consists of the bitfile name plus the store 11^.) 
Migration uses tliis organization so that a bitfile can be located 
by using the he?iadecimal encoding of the bitfile ID. 



Bitfile Hierarchy 




j 5F8178A000 1010 0^ •■• C^]^]25F8178A00 0101FF ^ 
Maximum of 2563 = 16M bitfiles 
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